home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Ham Radio 2000
/
Ham Radio 2000.iso
/
ham2000
/
bbs
/
file20
/
file.doc
< prev
next >
Wrap
Text File
|
1994-10-29
|
14KB
|
324 lines
FILE 2.0 (C) 1994 by Dean R. Madsen, KE0WO
After numerous requests for an alternative to PICK for automatic
filing of messages, I have finally found time to create such a program.
Hopefully those that have had little luck getting PICK to function will have
an easier time with FILE.
Features:
Selects messages based on any combination of: the message type, the "From"
field, The "To" field, the "@BBS" distribution field, the message bid, and/or
the message subject.
The * wildcard is allowed ( *word, word*, *word*).
Eleven (11) file naming options are supported for files created from selected
messages.
Files go to user settable directories.
Reads the INIT.SRV file so you don't have to tell the program where the mail
files are or your callsign, etc.
The same message may be archived for each search line it qualifies for.
An index file may be created.
Files maybe added to the YAPPLBL.SYS with a label.
The R: forwarding headers may be omitted from the saved files.
Uses:
Archive personal mail for later reference...
Archive locally generated messages for record keeping/possible
license protection in the US (read "It Seems to Us" in June(?) '94 QST).
Allows informational bulletins to be automatically added to file sections.
(ie: ARRL bulletins, RACES bulletins, regional network bulletins.
-----------------------------Installation--------------------------------
The only requirement is that all the FILE.* files are located in the same
directory and the FBB 5.15 INIT.SRV is either in the current directory or in
the \FBB directory of the same drive.
-----------------------------FILE.ADD------------------------------------
The contents of this file is added to the beginning of each message archived
by FILE. If the file doesn't exist, or contains no text, nothing is added.
-----------------------------INDEX.FIL--------------------------------------
The contents of the INDEX.FIL becomes each line in the index file.
-----------------------------variables--------------------------------------
To permit everyone to tailor this file to their liking, I have implemented
variables to have the FILE program include variable info into the file.
Each variable must begin with a $ and be in lower case.
Variables:
$@ - @BBS field of message being archived.
$@_ - @BBS field formatted to 7 characters.
$thisbbs - Callsign as found in INIT.SRV.
$to - "To" field of message being archived.
$to_ - "To" field formatted to 7 characters.
$type - type of message being archived.
$from - "from" field of message being archived.
$from_ - "from" field formatted to 7 characters.
$date - date of message origination in the YYMMDD format
$dateusa - date of message origination in the U.S. MM/DD/YY format.
$dateeu - date of message origination in the DD/MM/YY format that everyone
else uses.
$time - time of message origination (hh:mm)
$msize - size of message/file created from the message.
$bid - the BID/MID of the message being archived.
$bid_ - the BID/MID formatted to 13 characters.
$subject - the subject of the message being archived.
$filename - Name of the file the messages is currently being saved to.
$filename_- Name of the file formatted to 14 characters.
------------------------------FILE.CFG--------------------------------------
This is the file where you setup messages to be archived, etc. All lines
begining with a # are considered comment lines. Fields are separated by
commas (,). Currently there is a limit of 173 search lines. When I tried
to get it set higher I get an error message from my compiler. This is an area
for improvement in any future versions. THERE MUST BE NO SPACES _EXCEPT_ IN
THE SUBJECT SEARCH FIELD!
again: THERE MUST BE NO SPACES _EXCEPT_ IN THE SUBJECT SEARCH FIELD!
The line format is:
Type,From,@BBS,TO,BID/MID,SUBJECT,Drive:\PATH\,Save method,Indexing
For right now I will forget the last field (save method) and explain it later.
Examples:
# Archive all Bulletin type mesages.
B,*,*,*,*,*,C:\BULLETIN\,1,1
# Archive all messages from KE0WO
*,KE0WO,*,*,*,*,C:\KE0WO\,1,1
# Archive all messages with the @ distribution of IOWA
*,*,IOWA,*,*,*,C:\IOWA\,1,1
# Archive all messages to KE0WO
*,*,*,KE0WO,*,*,C:\KE0WO\,1,1
# Archive all messages with a BID/MID ending in _KE0WO (all messages originated
# on KE0WO BBS)
*,*,*,*,*_KE0WO,*,C:\LOCAL\,1,1
# Archive all messages with the string (case insensitive) "NOAM" in the subject
# Result: Archive most of the NA vs. NOAM debate messages.
*,*,*,*,*,*NOAM*,C:\NOAMVSNA\,1,1
Then you can start combining things to be most specific in message selection:
# Archive all messages sent to FBB @ ALLUS from anyone with the prefix "KE"
*,KE*,ALLUS,FBB,*,*,C:\FBBSTUFF,1,1
# Archive all personal messages to SYSOP with the work "ILLEGAL" in the subject
P,*,*,SYSOP,*,*ILLEGAL*,C:\SYSOP\,1,1
# Archive all Bulletins messages from KE0BX to MAP* with the distribution of
# IOWA
B,KE0BX,IOWA,MAP*,*,*,C:\FILES\MAPS\,1,1
Now for the file naming options:
1 - Save by local message number (message # 100101 becomes file 100101.)
2 - Save by BID/MID
3 - Save by name specified in the directory field. If C:\FILES\STUFF,3
is the directory/save number. Messages will be saved as
C:\FILES\STUFF.001 to C:\FILES\STUFF.999
4 - Save into name.ext (append messages). If C:\FILES\STUFF.TXT,3
is the directory/save number. Messages will be saved as
C:\FILES\STUFF.TXT (later messages being appended to the file).
5 - Name files using the "From" field of the message being archived.
Use the extensions .001 - .999
6 - Name files using the "From" field of the message being archived.
Append later messages.
7 - Name files using the "to" field of the message being archived.
Use the extensions .001 - .999
8 - Name files using the "to" field of the message being archived.
Append later messages.
9 - Name files using the "@bbs" field of the message being archived.
Use the extensions .001 - .999
0 - Name files using the "@bbs" field of the message being archived.
Append later messages.
10 - Name files using the current date in the YYMMDD format.
Append later messages.
The indexing options:
0 - No indexing.
1 - Create an ASCII index file only
2 - Add the file to the YAPPLBL.SYS only so it shows up when the LIST
command is used.
3 - Create an ASCII index file AND add the file with label to the
YAPPLBL.SYS.
4 - No indexing. Remove R: forwarding headers.
5 - Create an ASCII index file only and remove R: forwarding headers.
6 - Add the file to the YAPPLBL.SYS only so it shows up when the LIST
command is used and remove R: forwarding headers.
7 - Create an ASCII index file And add the file with lavl to the
YAPPLBL.SYS and remove R: forwarding headers.
------------------------------FILE.REJ--------------------------------------
This is basically the REJECT.SYS of the FILE program. When a match is made
according the settings of FILE.CFG. FILE looks for a match with the contents
of FILE.REJ, if it finds a match again, the message WILL NOT be archived.
If FILE.REJ does not exist, then all message matching the FILE.CFG will be
archived.
The line format is:
Type,From,@BBS,TO,BID/MID,SUBJECT
Note this is ALMOST the same as FILE.CFG.
-------------------------Where to I run this?----------------------
In previous programs (REPORT) I assumed that people would realize you run this
type from APPEL.BAT, but from the questions I have received, I should state
that FILE should be run in the APPEL.BAT housekeeping section BEFORE the
EPURMESS program.
------------------------------ BUGS? -------------------------------
$m mm m So far I have found the program
"$mmmmm m$" mmmmmmm$" works fine. The ONLY problem I
"""$m m$ m$"""""" can think of is with the naming
mmmmmmm$$$$$$$$$"mmmm files by BID/MID. BID/MIDs can
mmm$$$$$$$$$$$$$$$$$$ m$$$$m " / be longer than DOS file name as
$$$$$$$$$$$$$$$$$$$$$$ $$$$$$"$$$ / well as contain characters that
mmmmmmmmmmmmmmmmmmmmm $$$$$$$$$$ DOS can't handle in file names..
$$$$$$$$$$$$$$$$$$$$$ $$$$$$$""" \ I did take some steps to compensate,
"$$$$$$$$$$$$$$$$$$$$$ $$$$$$ " \ but I am sure I didn't cover
"""""""$$$$$$$$$$$m """" everything. This is an area of
mmmmmmmm" m$ "$mmmmm improvement for future versions.
$$"""""" "$ """"""$$
m$" "m " Another problem may be that the number
" of seconds since Jan. 1, 1970
is getting larger, it may get
high enough to cause problems due
the short comings of my compiler.
Usually a run-time error 215 will
signal this happening. To circumvent
this, disable the updating of the
YAPPLBL.SYS file throughout the
FILE.CFG.
---------------------Something I almost forgot to mention------------------
So the program doesn't archive the same messages next time it is run, the
file FILE.NUM is created to keep track of the last message the program
processed. Delete it and the program will look through all messages and then
recreate the file.
------------------------------- Conclusion ---------------------------------
1. This software is freeware to the amateur community. It may not be sold.
It may be freely copied and distributed, but at no charge exceeding the
medium and shipping. Commericial use of this software is prohibited
without licensing from the author.
2. No warranty is expressed or implied and incidental damages resulting from
the use of this software are solely the responsibility of the user. While
the software works fine, and I am willing to release it to the amateur
community, I am not willing to assume any liabilty for it crashing your
computer or its peripherals. (It has not done that on any machine I have
ran it on...this is just legal junk to prevent someone from holding me
responsible for being generous enough to produce this utility as a
service to the FBB community.)
3. Feedback on desired features, bugs, etc. are encouraged.
4. I have given up on the "send money" type message that used to go here.
Instead, how about helping your fellow amateur instead of flaming him?
If you can make this hobby more enjoyable for others, then that follows
the spirit with which my programs are made. For this, I say "Thank You!".
5. I expect that my release will be UNALTERED. If I connect to a board and
find this software package, I expect it to be unchanged and named
FILE20.EXE. I don't want to see it as FILE20.ARJ or another name.
If I take the time to release this software, the least you can do is not
change it.
If you have any problems, questions, comments, etc. you can contact me via:
Telephone:
Home: (712) 732-2021
College: (515) 296-9471 (later part of August, until first part
of December excluding the week long
Thanksgiving break in November. Second
semester begins later part of January
and ends in the first part of May with
a week long spring break in there
somewhere. Some weekends I may be home.
If in doubt, you can call my home # and my
parents will tell you how to reach me.)
U.S. Mail:
Home: Dean R. Madsen
P.O. Box 303
Storm Lake, IA 50588
USA
College: Dean R. Madsen
Wallace 7348 Lancelot
Iowa State University
Ames, IA 50013
USA
Data : (712) 732-3767 - 14400,N,8,1 . Enter your call at the prompt,
then type Y to proceed.
Latest KE0WO servers/utilities in the SERVERS
subdirectory of my file section in FBBDOS.
Internet: dmadsen@iastate.edu
Internet FTP: I will try tohave my latest stuff available on my
my Internet FTP site for those that want the
latest works, or would like to test beta
software that I may be working on.
FTP vincent.iastate.edu and login as
anonymous.dmadsen then sent your email
address as your password. I will try to
set up some sort of logical directory
structure in the near future. I plan to have
my servers in the directory ke0wo and beta
versions in the beta directory.
I will also try to get my servers to
FTP.FUNET.FI somewhere in the
/pub/ham/packet/bbs/f6fbb subdiretories.
Packet Radio: KE0WO @ KE0WO.#NWIA.IA.USA.NA
Hope you find this software useful,
73,
Dean - KE0WO